home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d17 / lpr_lpq3.arc / LPQ.DOC < prev    next >
Text File  |  1989-10-14  |  4KB  |  68 lines
  1.  
  2. NAME
  3.      lpq - display and manipulate the DOS print queue
  4.  
  5. SYNOPSIS
  6.      lpq [-c n] [-p n] [-t] [-s] [-r] [-1] [-v] [-h]
  7.  
  8. DESCRIPTION
  9.      lpq is a utility to display the files in the current print queue, along
  10.      with the file size and a sequential job number in the queue. lpq can
  11.      also manipulate the entries in the queue using the following options:
  12.         -c n    Cancel the job number (n) from the queue, where the job
  13.                 number is obtained from the lpq output listing.  Multiple
  14.                 -c n may be specified.
  15.         -p n    Priority to job (n).  lpq will move job (n) to the head of
  16.                 the queue and demote all other jobs by one place.
  17.         -t      Terminate printing and remove all jobs from queue.
  18.         -s      Suspend printing operation.  The current print job will
  19.                 complete, but no more will print until the queue is
  20.                 released. Print will consider the queue to have emptied,
  21.                 and the printer port will be available to other
  22.                 applications. The entries are still in the queue however
  23.                 and may be released by calling lpq with the -r option.
  24.                 May be specified along with other options.
  25.         -r      Release the print queue suspended by the -s flag.
  26.         -v      Verbose mode.  lpq is more chatty about it's activities.
  27.         -h      Display brief help text and exit.
  28.         -1      display the queue 1 file per line with no extraneous
  29.                 messages
  30.  
  31.         If any of the above options are given on the command line, lpq will
  32.     perform the requested action and then display the print queue. If no
  33.     arguments are given, lpq reports the current state of the print queue,
  34.     with a job number and file size for each entry.  If the file was entered
  35.     into the queue using lpr, the time of entry into the queue is also
  36.     displayed.  If a file has been deleted while still in the queue, this is
  37.     reported also. It is possible to delete a file in the queue and PRINT
  38.     will not notice until it reaches the head of the queue since it does not
  39.     have an open handle on the queued files.  Deleting the file currently
  40.     printing will result in a file sharing violation if share is installed,
  41.     but otherwise is allowed, and will result in termination of the print
  42.     job.  Options are processed in the order given.  It is possible to
  43.     specify more than one -c or -p on the command line.  The percentage printed
  44.     (of the file currently printing) will also be displayed.  This is
  45.     obtained by snooping in the system file table.
  46.  
  47.     lpq communicates directly with the print spooler by the TSR multiplex
  48.     interrupt 2FH.  This is documented for DOS 3.x and later.  It might
  49.     be possible to make it work with DOS 2.x since this used int 2F, but not
  50.     in the same way.
  51.  
  52. SEE ALSO
  53.     lpr, MS-DOS manual entry for PRINT
  54.  
  55. BUGS
  56.     The file time displayed by lpq is actually stored in the unused bytes of
  57.     the print queue entry, since few pathnames are actually this long (up to
  58.     64 bytes). If the pathname is too long, the time is missing.  If the
  59.     queue is loaded using "print" rather than lpr, it is possible that lpq
  60.     might find a "time" which is invalid.  This should not cause problems
  61.     beyond a bad time field in the lpq display.  The undocumented DOS service
  62.     52H (get "list of lists") is used to find out the current file pointer
  63.     position for the file handle used by print.com.  This should work for DOS
  64.     2.x, 3.x, 4.x but is not guaranteed.
  65.  
  66. AUTHOR
  67.     Richard Brittain  (richard@calvin.spp.cornell.edu)
  68.